:target{#body-elements}

# Body Elements

:target{#inline-markup}

## Inline Markup

Paragraphs contain text and may contain inline markup: <em>emphasis</em>,
<strong>strong emphasis</strong>, `inline literals`, standalone hyperlinks
([https://www.python.org](https://www.python.org)), external hyperlinks ([Python](https://www.python.org) <sup id="id20">:target{#id20}[4](#id19)</sup>), internal
cross-references ([example](#example)), external hyperlinks with embedded URIs
([Python web site](https://www.python.org)), footnote references
(manually numbered <sup id="id1">:target{#id1}[1](#id8)</sup>, anonymous auto-numbered <sup id="id2">:target{#id2}[3](#id11)</sup>, labeled
auto-numbered <sup id="id3">:target{#id3}[2](#label)</sup>, or symbolic <sup id="id4">:target{#id4}[\*](#id12)</sup>), citation references
(:target{#id5}[\[CIT2002\]](#cit2002)), substitution references (![EXAMPLE](_assets/biohazard.png)), and <span id="inline-hyperlink-targets">inline
hyperlink targets</span> (see [Targets](#targets) below for a reference back to here).
Character-level inline markup is also possible (although exceedingly
ugly!) in <em>re</em>`Structured`<em>Text</em>.  Problems are indicated by
<del id="id18">|problematic|</del> text (generated by processing errors; this one is
intentional).

:target{#targets}

### Targets

:target{#example}

This paragraph is pointed to by the explicit "example" target. A
reference can be found under [Inline Markup](#inline-markup), above. [Inline
hyperlink targets](#inline-hyperlink-targets) are also possible.

Section headers are implicit targets, referred to by name. See
[Targets](#targets), which is a subsection of [Body Elements](#body-elements).

Explicit external targets are interpolated into references such as
"[Python](https://www.python.org) <sup id="id21">:target{#id21}[4](#id19)</sup>".

Targets may be indirect and anonymous.  Thus [this phrase](#targets) may also
refer to the [Targets](#targets) section.

Here's a <del id="id23">\`hyperlink reference without a target\`\_</del>, which generates an
error.

:target{#duplicate-target-names}

## Duplicate Target Names

Duplicate names in section headers or other implicit targets will
generate "info" (level-1) system messages.  Duplicate names in
explicit targets will generate "warning" (level-2) system messages.

:target{#id7}

## Duplicate Target Names

Since there are two "Duplicate Target Names" section headers, we
cannot uniquely refer to either of them by name.  If we try to (like
this: <del id="id25">\`Duplicate Target Names\`\_</del>), an error is generated.

:target{#footnotes}

### Footnotes

<Footnote label="1" backrefs={["id1", "id9"]} id="id8">
  A footnote contains body elements, consistently indented by at
  least 3 spaces.

  This is the footnote's second paragraph.
</Footnote>

<Footnote label="2" backrefs={["id3", "id10"]} id="label">
  Footnotes may be numbered, either manually (as in <sup id="id9">:target{#id9}[1](#id8)</sup>) or
  automatically using a "#"-prefixed label.  This footnote has a
  label so it can be referred to from multiple places, both as a
  footnote reference (<sup id="id10">:target{#id10}[2](#label)</sup>) and as a hyperlink reference
  ([label](#label)).
</Footnote>

<Footnote label="3" backrefs={["id2"]} id="id11">
  This footnote is numbered automatically and anonymously using a
  label of "#" only.
</Footnote>

<Footnote label="*" backrefs={["id4"]} id="id12">
  Footnotes may also use symbols, specified with a "\*" label.
  Here's a reference to the next footnote: <sup id="id13">:target{#id13}[†](#id14)</sup>.
</Footnote>

<Footnote label="†" backrefs={["id13"]} id="id14">
  This footnote shows the next symbol in the sequence.
</Footnote>

<Footnote label="CIT2002" backrefs={["id5", "id15"]} id="cit2002">
  Citations are text-labeled footnotes. They may be
  rendered separately and differently from footnotes.
</Footnote>

:target{#citations}

### Citations

Here's a reference to the above, :target{#id15}[\[CIT2002\]](#cit2002), and a \[nonexistent]
citation.

:target{#substitution-definitions}

### Substitution Definitions

An inline image (![EXAMPLE](_assets/biohazard.png)) example:

:target{#target-footnotes}

### Target Footnotes

<Footnote label="4" backrefs={["id20", "id21"]} id="id19">
  [https://www.python.org](https://www.python.org)
</Footnote>
